home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 1998 November / IRIX 6.5.2 Base Documentation November 1998.img / usr / share / catman / g_man / cat3 / OpenGL-ftn / fglsamplepatternsgis.z / fglsamplepatternsgis
Text File  |  1998-10-20  |  9KB  |  133 lines

  1.  
  2.  
  3.  
  4. ffffggggllllSSSSaaaammmmpppplllleeeePPPPaaaatttttttteeeerrrrnnnnSSSSGGGGIIIISSSS((((3333GGGG))))       OOOOppppeeeennnnGGGGLLLL RRRReeeeffffeeeerrrreeeennnncccceeee       ffffggggllllSSSSaaaammmmpppplllleeeePPPPaaaatttttttteeeerrrrnnnnSSSSGGGGIIIISSSS((((3333GGGG))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      ffffggggllllSSSSaaaammmmpppplllleeeePPPPaaaatttttttteeeerrrrnnnnSSSSGGGGIIIISSSS - set pattern for multisampling
  10.  
  11.  
  12. FFFFOOOORRRRTTTTRRRRAAAANNNN SSSSPPPPEEEECCCCIIIIFFFFIIIICCCCAAAATTTTIIIIOOOONNNN
  13.      SUBROUTINE ffffggggllllSSSSaaaammmmpppplllleeeePPPPaaaatttttttteeeerrrrnnnnSSSSGGGGIIIISSSS( INTEGER*4 _p_a_t_t_e_r_n )
  14.  
  15.  
  16. PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRRSSSS
  17.      _p_a_t_t_e_r_n  A symbolic constant that indicates the sampling pattern to be
  18.               used when multisampling is enabled.  The allowable values are
  19.               GGGGLLLL____1111PPPPAAAASSSSSSSS____SSSSGGGGIIIISSSS, GGGGLLLL____2222PPPPAAAASSSSSSSS____0000____SSSSGGGGIIIISSSS, GGGGLLLL____2222PPPPAAAASSSSSSSS____1111____SSSSGGGGIIIISSSS,
  20.               GGGGLLLL____4444PPPPAAAASSSSSSSS____0000____SSSSGGGGIIIISSSS, GGGGLLLL____4444PPPPAAAASSSSSSSS____1111____SSSSGGGGIIIISSSS, GGGGLLLL____4444PPPPAAAASSSSSSSS____2222____SSSSGGGGIIIISSSS, and
  21.               GGGGLLLL____4444PPPPAAAASSSSSSSS____3333____SSSSGGGGIIIISSSS.
  22.  
  23. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  24.      ffffggggllllSSSSaaaammmmpppplllleeeePPPPaaaatttttttteeeerrrrnnnnSSSSGGGGIIIISSSS is part of the SGIS_multisample extension.  This
  25.      extension provides multisampling, a mechanism for antialiasing all GL
  26.      primitives: points, lines, polygons, bitmaps, and images.  Multisample
  27.      antialiasing is most valuable for rendering polygons, because it requires
  28.      no sorting for hidden surface elimination, and it correctly handles
  29.      adjacent polygons, object silhouettes, and even intersecting polygons.
  30.      If only points or lines are being rendered, the "smooth" antialiasing
  31.      mechanism provided by the base GL may result in a higher quality image.
  32.      This extension is designed to allow multisample and smooth antialiasing
  33.      techniques to be alternated during the rendering of a single scene.
  34.  
  35.      The technique is to sample all primitives multiple times at each pixel.
  36.      The color sample values are resolved to a single, displayable color each
  37.      time a pixel is updated, so the antialiasing appears to be automatic at
  38.      the application level.  Because each sample includes depth and stencil
  39.      information, the depth and stencil functions perform equivalently to the
  40.      single-sample mode.
  41.  
  42.      An additional buffer, called the multisample buffer, is required.  Pixel
  43.      sample values, including color, depth, and stencil values, are stored in
  44.      this buffer.  When the frame buffer includes a multisample buffer, it
  45.      does not also include separate depth or stencil buffers, even if the
  46.      multisample buffer does not store depth or stencil values.  Color buffers
  47.      (left/right, front/ back, and aux) do coexist with the multisample
  48.      buffer, however.
  49.  
  50.      The locations of the sample points are relatively static.  They change
  51.      only when ffffggggllllSSSSaaaammmmpppplllleeeePPPPaaaatttttttteeeerrrrnnnnSSSSGGGGIIIISSSS is called, and are a repeatable function
  52.      of the parameter _p_a_t_t_e_r_n.  The default pattern GGGGLLLL____1111PPPPAAAASSSSSSSS____SSSSGGGGIIIISSSS is designed
  53.      to produce a well antialiased result in a single rendering pass.
  54.      Patterns GGGGLLLL____2222PPPPAAAASSSSSSSS____0000____SSSSGGGGIIIISSSS and GGGGLLLL____2222PPPPAAAASSSSSSSS____1111____SSSSGGGGIIIISSSS together specify twice the
  55.      number of sample points per pixel.  It is intended that a scene be
  56.      completely rendered using pattern GGGGLLLL____2222PPPPAAAASSSSSSSS____0000____SSSSGGGGIIIISSSS, then completely
  57.      rendered again using GGGGLLLL____2222PPPPAAAASSSSSSSS____1111____SSSSGGGGIIIISSSS.  When these two images are averaged
  58.      using the accumulation buffer, the result is as if a single pass had been
  59.      rendered with a pattern of twice the number of sample points.  Patterns
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. ffffggggllllSSSSaaaammmmpppplllleeeePPPPaaaatttttttteeeerrrrnnnnSSSSGGGGIIIISSSS((((3333GGGG))))       OOOOppppeeeennnnGGGGLLLL RRRReeeeffffeeeerrrreeeennnncccceeee       ffffggggllllSSSSaaaammmmpppplllleeeePPPPaaaatttttttteeeerrrrnnnnSSSSGGGGIIIISSSS((((3333GGGG))))
  71.  
  72.  
  73.  
  74.      GGGGLLLL____4444PPPPAAAASSSSSSSS____0000____SSSSGGGGIIIISSSS, GGGGLLLL____4444PPPPAAAASSSSSSSS____1111____SSSSGGGGIIIISSSS, GGGGLLLL____4444PPPPAAAASSSSSSSS____2222____SSSSGGGGIIIISSSS, and GGGGLLLL____4444PPPPAAAASSSSSSSS____3333____SSSSGGGGIIIISSSS
  75.      together define a pattern of four times the number of sample points. They
  76.      can be used to accumulate an image after four complete rendering passes.
  77.  
  78.  
  79. NNNNOOOOTTTTEEEESSSS
  80.      It is not possible to query the actual sample locations of a pixel.
  81.  
  82.      Some sample locations may lie outside the unit square that is considered
  83.      to bound the pixel.
  84.  
  85.      ffffggggllllSSSSaaaammmmpppplllleeeePPPPaaaatttttttteeeerrrrnnnnSSSSGGGGIIIISSSS is part of the SSSSGGGGIIIISSSS____mmmmuuuullllttttiiiissssaaaammmmpppplllleeee extension, not part
  86.      of the core GL command set.  If GGGGLLLL____SSSSGGGGIIIISSSS____mmmmuuuullllttttiiiissssaaaammmmpppplllleeee is included in the
  87.      string returned by ffffggggllllGGGGeeeettttSSSSttttrrrriiiinnnngggg, when called with argument GGGGLLLL____EEEEXXXXTTTTEEEENNNNSSSSIIIIOOOONNNNSSSS,
  88.      extension SSSSGGGGIIIISSSS____mmmmuuuullllttttiiiissssaaaammmmpppplllleeee is supported by the connection.
  89.  
  90.  
  91. EEEERRRRRRRROOOORRRRSSSS
  92.      GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____OOOOPPPPEEEERRRRAAAATTTTIIIIOOOONNNN is generated if ffffggggllllSSSSaaaammmmpppplllleeeePPPPaaaatttttttteeeerrrrnnnnSSSSGGGGIIIISSSS is executed
  93.      between the execution of ffffggggllllBBBBeeeeggggiiiinnnn and the corresponding execution of
  94.      ffffggggllllEEEEnnnndddd.
  95.  
  96.  
  97. AAAASSSSSSSSOOOOCCCCIIIIAAAATTTTEEEEDDDD GGGGEEEETTTTSSSS
  98.      ffffggggllllGGGGeeeetttt with argument GGGGLLLL____SSSSAAAAMMMMPPPPLLLLEEEE____PPPPAAAATTTTTTTTEEEERRRRNNNN____SSSSGGGGIIII.
  99.  
  100.  
  101.  
  102. MMMMAAAACCCCHHHHIIIINNNNEEEE DDDDEEEEPPPPEEEENNNNDDDDEEEENNNNCCCCIIIIEEEESSSS
  103.      Multisampling is supported only on RealityEngine, RealityEngine2, and VTX
  104.      and InfiniteReality systems.  Currently it can be used with windows of
  105.      multisample-capable Visual types, but not with pixmaps.
  106.  
  107.  
  108. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  109.      ffffggggllllSSSSaaaammmmpppplllleeeeMMMMaaaasssskkkkSSSSGGGGIIII, ffffggggllllPPPPuuuusssshhhhAAAAttttttttrrrriiiibbbb, ffffggggllllXXXXGGGGeeeettttCCCCoooonnnnffffiiiigggg, ffffggggllllXXXXCCCChhhhoooooooosssseeeeVVVViiiissssuuuuaaaallll,
  110.      ffffggggllllEEEEnnnnaaaabbbblllleeee with argument GGGGLLLL____MMMMUUUULLLLTTTTIIIISSSSAAAAMMMMPPPPLLLLEEEE____SSSSGGGGIIIISSSS.
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.